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Some Price Reductions... 


The other day I noticed that I could buy ten 3M diskettes ina 
nice hard-plastic library case for less than $ll at the local 
Safeway store. Wow! Times have changed! Our price keeps 
going down too, though. Now you can buy disks from us for 60 
cents apiece. A shrink-wrapped pack of 25 is only $15, 
including tyvek sleeves. 


We told you a few months ago about the Minuteman UPS from Para 
Systems. I still love mine, and I think you would also enjoy 
one as much as I do. We are lowering our price this month from 
$350 to $320, plus shipping charges. The Minuteman handles up 
to 250 watts. I run my Sider, printer, monitor, and //e with a 
full deck of cards including 1Meg RAMWORKS; there is probably 
ample power left for a few more items. My power is now 
filtered, surge protected, brownout protected, and blackout 
protected. 


Ultra-Fast Integer Square Roots...........-.-Charles H. Putney 
and Bob Sander-Cederlot 


Well, Bob wanted a faster integer square root program, so here 
it is! This method uses table lookup with as little as two 
pages of tables. The fastest version uses 2.75 payes of tables 
(704 bytes), and averages only 37 microseconds per root when 
teking all 65536 possible. The version which uses only 512 
bytes of tables is a little slower, but still a lot faster than 
the IBM PC program Bob mentioned a few months ago. 


Here's how my method works. First the input argument is 
shifted left two bits at a time until it is in the range from 
$4000 to SFFFF. I keep track of how many double-bit shifts 
this takes, from 0 to 7 times. Then I uSe the high byte of 
this value, which will be a number from $40 to SFF, to find the 
root in a table of 192 roots. Then I shift the root right from 
0 to 7 times, depending on the number of shift steps used 
before. The result is either the correct integer square root 
of the original number, or one less than the correct root. I 
can make the final correction by testing the original argument 
against a table of squares. I use the root taken from the 
first table as index into the second table. The value in the 
second table for root=N will be (Nt+l1)*(Nt1). If the original 
argument is less than N-plus-l-squared, then N is the correct 
root; otherwise, Ntl is the correct root. 


The program is shown below, with the tables. I used an Apple- 
soft program to actually generate the data for the tables, ina 
form which can be EXECed directly into the S-C Macro Assembler: 


10 DS = CHRS(4) 

20 PRINT CHRS (4);"OPEN SQUARE ROOT TABLE" 
30 PRINT CHRS (4);"WRITE SQUARE ROOT TABLE" 
40 HS = "0123456789ABCDEF" 

100 REM TABLE OF ROOTS 

110 PRINT “5000 TABLE1" 

120 FOR I = 0 to 23 

130 PRINT 5001+I “ >HS "; 

140 FOR J = 64 TO 71 

150 N = (1*8+J) * 256 

160 R = INT (SQR(N)) 

170 GOSUB 1000 

180 NEXT : PRINT: : NEXT 


200 REM TABLE OF SQUARES (LOW BYTES) 
210 PRINT “6000 TABLE2" 

220 FOR I = 0 TO 31 

230 PRINT 6001+I " >HS "“; 

240 FOR J = 1 TO 8 

250 N = I*8+J : N2 = N*N 

260 R = N2 - 256*INT(N2/256) 

270 GOSUB 1000 

280 NEXT : PRINT : NEXT 


300 REM TABLE OF SQUARES (HIGH BYTES) 


310 PRINT "7000 TABLE3" 
320 FOR I = 0 TO 31 
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S-C Macro Assembler Version 2.0.-.-- -DOS $100, ProDOS $100, both for $120 


Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownersS...-......ee020-4--- $20 
ProDOS Upgrade Kit for Version 2.0 DOS ownerS..- ...0-cec-coccccccccce $30 
Source Code of S-C Macro 2.0 (DOS only). -..... oocceee--e--additional $100 


Full Screen Editor for S-C Macro (with complete source code). ....-...949 
S-C Cross Reference Utility...- .without source code $20, with source $50 
RAK-Ware DISASM. ba eae eee without source code $30, with source $50 
S-C Word Processor (with complete source code). --...cceceeccves--cee- $50 
DP1S Source anG ODJeCteeac. Go Sein eiNawiewewes Ou Osseo a nese Ses 00020 0 990 
Double Precision Floating Point for Applesoft (with source code).-.... $50 
ES-CAPE (Extended S-C Applesoft Program Editor). . sera 

Including Version 2.0 With Source Code... -.....$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners).. --$30 
Bag of Tricks 2 (Quality Software). -....-ceccrccvccescvees ($49.95) $45 


MacASM -- Macro Assembler for MacIntosh (Mainstay). - - -(§150.00) $100 
S-C Documentor (complete commented source code of Applesoft ROMs)..-..$50 
Cross Assemblers for owners of S-C Macro Assembler..- $32.50 to $50 each 


(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, Z-8, 8048, 
8051, 8085, 1802/4/5, PDP-1l1l, GI1650/70, others) 


AAL Quarterly Disks....- -see eeeveee@ach $15, or any four for $45 
Each disk contains the source code from three issues of AAL: 
Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub rings). ~eeeseeee package of 25 for $15 
Vinyl disk pages, 6*x8.5", hold two Gisks each..- .wecreeeseeee--10 for $6 
Diskette Mailing Protectors (hold 1 or 2 disks). ---scecee-+--+-40 Cents each 

(Cardboard folders designed to fit 6"X9" Envelopes.) or $25 per 100 
Envelopes for Diskette MailerS.-. .-cccccses-oe---------e - 6 cents each 
65802 Microprocessor (Western DeSign Center).-.. -.-... Cees ~-- ($95) $50 
quikLoader EPROM System (SCRG). ~~ --«eecvecs cocccccccee ($179) $170 
PROmGRAMER (SCRG). TTC Ce Ee ee oe ee ee ($149.50) $140 
Switch-a-Slot (SCRG). ee Aevaeueleie Sate ee-e ($179.50) $170 
Minuteman 250 Uninterruptible Power Supply..- ...-ccccccccsse- ($359) $320 


"65816/65802 Assembly Language Programming", Fischer.--..--.. ($19.95) $18 
“Programming the 65816", Eyes.. see Gris area cues b swieeee (O22e99) S21 
“Apple //e Reference Manual“, Apple Computer..- - 2 Sistas vecow sain (S24 95) $23 
“Apple //c Reference Manual“, Apple Computer... -.....-.--.-( ($24.95) $23 
“ProDOS Technical Reference Manual", Apple Computer. --- - ($29.95) $27 
“Apple ProDOS: Advanced Features for pA Lanne rer Little.-($17.95) $17 
“Inside the Apple //c", Little. ~i@eeees (929695) “S18 
"Inside the Apple //e", Little. .. erence elaine ry 95) $18 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner. -. ($19.95) $18 
"Apple ][ Circuit Description", Gayler.-.. ......-.--. wiwawee (S22499) ~S21 
“Understanding the Apple II". Sather.. Mig SOS wee See OO) ie.) 
“Understanding the Apple //e", Sather.--  -....scccccccce-ee- ($24.95) $23 
"Enhancing Your Apple II, vol. 1", Lancaster... ia ret Ma: S19 S95): “S15 
“Enhancing Your Apple II, vol. 2", Lancaster. .- .-- ($17.95) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster-...-.-. -- ($21.95) $20 
“Beneath Apple DOS", Worth & Lechner. Leis peknekiesen eels oo). “Le 
"Beneath Apple ProDOS". Worth & Lechner.. ster cece cvecveeee ($19.95) $18 
"Real Time Programming -- Neglected PODLCE s Foster...- --..-($9.95) $9 
“Microcomputer Graphics", Myers.-. Veg. Gf Welw. Vaawaws ($14.95) $14 
"Assem. Language for Applesoft Programmers“ ’ “Pinley & Myers. ($18.95) $18 
“Assembly Lines -- the Book", Wagner. wg Bie Dene ee teeeee oe LOL eo) 21d 
“AppleVisions", Bishop & Grossberger.-- --.sseeccveee-- -- ($39.95) $36 


* On these items add $2.00 for the first item anda 
$.75 for each additional item for US shipping. 
+ Inquire for shipping cost. 
Foreign customers inguire for postage needed. 
Texas residents please add 6 1/8 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 


zee (214) 324-2050 ee* 
*** Master Card, VISA, Discover and American Express *** 
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++ eH 


t+t-eteeeutw-wteeeeneenet #e MN H&E HH HH OH 


330 PRINT 7001+I " >HS "; 

340 FOR J = 1 TO 8 

350 N = I*8+J : N2 = N*N 

360 R = INT(N2/256) : IF R>255 THEN R=0 
370 GOSUB 1000 

380 NEXT : PRINT : NEXT 


900 PRINT DS$"CLOSE" 
910 END 


1000 REM PRINT IN HEX 

1010 PRINT MIDS (HS, INT (R / 16) + 1,1); 

1020 PRINT MIDS (HS,R - 16 * INT (R / 16) + 1,1)"."3 
1030 RETURN 


‘The way I have written the SQRT subroutine, the high pyte ot 
the argument is expected in the X-register and the low byte in 
the A-register. The square root is returned in the Y-register, 
with A and X destroyed. This combination seemed to me to give 
the best speed. Lines 2290 and 2300 divde the arguments into 
two ranges: $4000-FFFF, and below $4000. The higher range 
comprises 75% of the possible arguments, a total of 49152. 


The top 256 possible arguments, from S$FFO0O to SFFFF, must be 
handled as a special case. The logic which compares roots 
against values in TABLE2 and TABLE3 is confused by the fact 
that the entry for SFF is $0000. (It really is $10000, but the 
leading 1 is not in either table.) Lines 2320-2330 strip out 
these arguments, and lines 2860-2870 return the correct root 
(SFF). A total of only 11 cycles (not counting JSR SQRT or 
RTS) for these 256 arguaments. 


If the range is from $4000 to SFEFF, as it is in 48896 cases, 
lines 2340-2410 return the correct root. The high-byte of the 
argument is already in the X-register, so line 2340 loads the 
Y-register with the trial root from the table. No shifting 
must be done, so lines 2350-2390 proceed to compare with the 
square of the root+l in TABLE2 and TABLE3. If the entry there 
is larger than the original argument, the root is correct; if 
not, line 2400 adds one, making it correct. The longest path 
from beginning to end for these arguments is only 28 cycles. 
If the test at line 2360 branches, it is only 19 cycles. Wow! 
And this takes care of three-fourths of all cases! 


Arguments below $4000 are handled by lines 2430 and following. 
Lines 2440-2450 test for arguments from $0000 to SOOFF. These 
will be handled by lines 2740-2840. If the argument is exactly 
$0000, the root is $00, and this is detected at lines 2740- 
2750. All other roots below $0100 need to be shifted at least 
4 two-bit steps. By merely starting to work on the low-byte, 
and with a shift-count of 4, we accomplish the first four steps 
without taking any time at all. The loop in lines 2790-2840 
normalizes the byte and continues to count shift steps. Then 
we joint the processing of values between $0100 and S3FFF. 


The range of arguments from $0100 to S3FFF are handled 


beginning at line 2470. The loop in lines 2510-2570 normalizes 
the argument by shifting left in two-bit steps until the value 
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is $4000 or more, counting the number of steps it takes. It 
will be 1, 2, or 3 steps. 


We come to line 2590 with a shift count in the Y-register. The 
count will be l, 2, or 3 the original argument was $0100 or 
more; it will be from 4 to 7 if the original argument was below 
$0100. We also come to line 2590 with the high-byte of the 
normalized argument in the A-register. Lines 2590-2600 used 
this byte to get a trial root from TABLE]. The loop in lines 
2610-2630 shifts the trial root right the same number of bits 
as we took in two-bit steps to normalize the argument earlier. 
Finally, lines 2640-2720 check the trial root against the value 
in TABLE2 and TABLE3, and correct the root if necessary. 


I had it all counted out at one time, and the arguments below 
$4000 (with the exception of $0000) take on the order of 80 
cycles, It gets very involved to try to count these paths, so 
I wrote a timing program instead. LInes 2070-2260 call the 
SQRT subroutine for each argument from $0000 to SFFFF, and do 
it ten times. This takes about 41 seconds to execute. For 
fun, I inserted line 2170 to toggle the Speaker after taking 
each square root; the sound is interesting, and also reveals 
the fact that lower roots take longer than higher roots. Lines 
2130 and 2250 turn on and off the ANO signal in the game port, 
for the timing setup I describe in another article in this 
newsletter. Line 2220 makes a visible mark on the screen so I 
will not get too impatient while the program is running. 


I ran the timing loop as shown first, and as I said it took 
about 41 seconds. My timing setup uSing another Apple to count 
cycles gave a result of 41,821,940 cycles. Then I changed line 
2280 from “SQRT“ to “SQRT RTS“, so I could time the overhead 
of the the timing program itself. My other Apple said this 
took 17,056,520 cycles. The difference is the time of SQRT 
itself, and this is 24,765,420. Remember that I took 65536 
square roots ten times: therefore I divide by 655360 to get an 
average cycle count of only 37.8 cycles. In English, that is 
about 37 microseconds. Wow! Tell that to your IBM friend! 


The program slows down if the tables are not properly placed in 
memory. Indexed instructions take an extra clock cycle if the 
indexing crosses a page boundary. Therefore, I adjusted the 
Start of the tables so that they fit in a page. Notice that 
TABLE] really starts 64 bytes into the page. This is so 
because the index we uSe to access TABLE] runs from $40 to SFF.. 
The label ROOT is equated to TABLE1-64, at line 4010. 


All this timing is irrelevant if the program produces incorrect 
results. Therefore an exhaustive test is necessary. I wrote a 
test program in Applesoft, but it was very slow. Therefore I 
converted it to assembly language, with the result in lines 
1340-2050. The test program has some interesting wrinkles in 
it. It checks all the square roots from SQRT without actually 
having any code to multiply, divide, or take a square root. 


The test program runs through the possible arguments in 


sequential order, from $0000 to SFFFF. If the answer returned 
by SQRT is correct, it will pass the following tests: 
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RamFactor 


All the Performance, Speed, and Software 
Compatibility of RamWorks" in a Slot 1 through 7 Card. 


ghee right’ Now Applied Engineering offers you a choice. While RamWorks is the dear 

winner for the auxiliary slot in a Ile, RamFactor is the standard for slots 1 through 7. Now 

anyone with an Apple II+, Franklin, or Apple He preferring to use slots 1 through 7 can now 
- enjoy the speed and performance that unt now was only available with RamWorks. 

With RamFactor, you'll be able to instanty add another 256K, 512K, or a full 1 meg on the 
main board and up to 16 meg with additional piggyback card. And since virtually all software 
is automatically compatible with RamFactor, you'll immediately be able to load programs into 
RamFactor for instantaneous access to information. You'll also be able to store more data for 
larger word processing documents, bigger data bases, and expanded spreadsheets 


Very Compatible 

All the leading software is already com- 
patible with RamFactor. Programs like Apple- 
Works, Pinpoint, BPI, Managing Your Money, 
Dollars and Sense, SuperCalc 3A, PFS, Mouse- 
Write, MouseDesk, MouseCalc, Sensible 
Speller, Applewriter Ile, Business Works, 
ReportWorks, Catalyst 3.0 and more. And 
RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 
and CP/M compatible. In fact, no other 
memory card (RamWorks excepted) is more 
compatible with commercial software. 
AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 
slot 1-7 card that increases AppleWorks 
internal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load AppleWorks into RAM 
dramatically increasing speed and eliminating 
the time required to access the program disk, 
it will even display the time and date on the 
AppleWorks screen with any ProDos dock 
RamFactor will automatically segment large 
files so they can be saved on 5%”, 342", and 
hard disks All this performance is available to 
anyone with an Apple Ile or II+ with an 80 
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column card. RamFactor, no other standard 
slot card comes close to enhancing Apple- 
Works so much. 


True 65C816 16 Bit Power 

RamFactor has a built-in 65C816 CPU port 
for direct connection to our He 65C816 card 
for linearly addressing up to 16 meg for the 
most powerful 16 bit applications. (11+ 
65C816 card under development ) 


Powerful Program Switcher 

With RamFactor, you can organize 
memory into multiple work areas and switch 
between them Each work area can contain 
different programs and even different operat: 
ing systems. Now you can switch from one 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second And with our 
Battery back-up option, you can have 
permanent storage for up to 20 years. 


Quality and Support of the 
Industry Leader 

RamFactor is from Applied Engineering, 
the largest, most well supported manufacturer 
of Apple peripherals and the inventor of large 
RAM cards for the Apple. With our 5 year no 
hassle warranty and outstanding technical 
support, you're assured of the most trouble 
free product you can buy. 


November, 1986. 


Features: 

e Up to 16 meg total memon, 256K to | 

meg on main board Up to 16 meg with 

additional memory on piggyback card 

Fully Apple IE Memory Expansion com 

patible 

e Compatible with Apple Ie, H+ and 
Frankii 

e Battery back-up option allows you to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal and CP/M 


| ¢ Builtin RamDrive™ software (a true RAM 


disk not disk caching) 

Systems are directly bootable from Ram- 

Factor if desired 

Built-in linear addressing 16 bit 

co-processor port 

e Built-in self diagnostic software 

e Automatic expansion with AppleWorks 1.3 
or later 

e Allows Apple I+ and Ie to run vour 
AppleWorks without buying additional 
software 


e Accelerates AppleWorks 


e Displays ime and date on the AppleWorks 
screen with any ProDos clock 

Fits any I/O slot except slot 3 

e Fully socketed and user upgradeable 

e Much, much more 


RamFactor with 256K 
RamFactor with 512K 
RamFactor with 1 MEG 


RamFactor with 2-16 MEG 
Battery Back-up Option 
65C816 16 Bit Card 


Order RamFactor today .. . with 15 day 
money back guarantee and our “no hassle” 
five year warranty. Cal9 am. to 11 p.m, 7 
days, or send check or money order to 
Applied Engineering, MasterCard, Visa and 
COLD. welcome. Texas residents add 5%% 
sales tax, Add $10.00 if Outside U.S.A 


AK Applied Engineering” 
The Apple enbancement experts 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 
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it will be the same 
Or it will be the pr 


if it is the same as 
the argument 
the “next pe 


if it is prev. root 
the argument 
equal to the 


I keep a running value for 
1 (the next perfect square 
find that the argument has 


as the previous root, 
evious root + l. 


the previous root, 
must still be less than 
rfect square” 


+ 1, 
must be greater than or 
"next perfect square" 


“next perfect square". I start witn 
after 0*0 is 1*1). Then each time I 
reached the value of the “next 


perfect square", 


that (n+l)°2 = 


Lines 1550, 


1780, 
is running, and helped me find a bug or two. 


I bump it 


and 1860 


up by adding 2*roottl. 
n°2 + 2%n +1. 


Remember 


indicate visually that the program 
Lines 1930-2050 


print out the important information when an error is detected. 


Lines 1280-1320 allowed me to call SQRT from inside an 


Applesoft program. 


However, this is not foolproof because 


there may be page-zero conflicts as the program is now written. 
It worked fine for my tests, though. 


1000 *SAVE S.PUTNEY-RBSC FISQR 
1020 : ULTRA FAST INTEGER SQUARE ROOTS 
1080 BY: CHARLES H. PUTNEY 
1950 8 18 QUINNS ROAD 
10 8 SHANKILL, CO. DUBLIN, IRELAND 
1080 ® INPUT: X = ARG HIGH BYTE 
1090 : A = ARG LOW BYTE 
1110 ® OUTPUT: Y=INTEGER SQUARE ROOT OF X,A 
1120 # X AND A DESTROYED 
1130 8 
11h! Seceeeesese eee beece cc set eee 
00- 1150 BAS.ARG  .EQ $00,01 
02— 1160 NUMBER -EQ $02, 03 
Oh 1170 ARGSAV -EQ $04, 05 
06- 1180 ARGLO EQ 
O7- 1190 TEN.TIMES -EQ $0 
08- 1200 OLD.ROOT -EQ $0 
09- 1210 NEW.ROOT .EQ $09 
OA- 1220 RR -EQ $0A, 0B 
OC- 1230 gs -EQ $0C, 0D, 0E 
1250 .OR $6000 OUT OF THE WAY 
12 0 . -TF SQUARE ROOT. OBJ 
6000- A5 00 1280 BASENT LDA BAS/ARG USE LOW 2 0 
6002- A6 01 1290 LDX BAS.ARG+1 HIGH = 1 
6004- 20 C1 60 1300 JSR SQRT TEST IT 
007- 84 00 1310 STY BAS.ARG RETURN IN 0 
6009- 60 1320 RTS 
1330 Bosse acetone eoosn cases cceee 
1340 TEST 
600A- AJ 00 ~—-1350 LDA #0 
600C- 85 02 ~=1360 STA NUMBER 
600E- 85 0 1379 STA NUMBER+1 
6010- 85 0 1380 STA OLD. ROOT 
6012- 85 OA 1390 STA RR 
6014- 85 0B 1400 STA RR+1 
6016- 85 OD ~—«-1410 STA SS+1 
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N) 
1 LDA NUMBER 
LDX NUMBER+1 
SQRT 
STY NEW. ROOT 
CPY OLD. ROOT 


2 
INC OLD. ROOT 
CPY OLD. ROOT 


SS 


RR 
LDA SS+1 
RR+1 


ROL NEW. ROOT 
#0 


ADC SS+1 
STA aie 


INC SS+2 
2 LDA NUMBER ERROR IF NUMBER < RR 


RR 
LDA NUMBER+1 
RR+1 


c NUMBER 
INC NUMBER+1 


SET UP FOR SQRT ENTRY 
FIND THE SQUARE ROOT 


SAME AS OLD ROOT 
ERROR 

ERROR 

SS = RR 


ss SS + R + R + 1 


SAVE HIBYTE OF 2*R+1 


SS 
ADC NEW. ROOT 
SS 


A NUMBER ERROR IF NUMBER >= SS 


WRAPPED ? 
DONE 65536 ? 


-99 LDA NUMBER+1 
$FDDA 
LDA NUMBER 


1 
DO IT ALL TEN TIMES 


LDA $C059 START TIMER 
2140 .1 LDA NUMBER SET UP FOR SQRT ENTRY 
2150 LDX NUMBER+1 


160 JSR 
2170 # LDA $C030 


SQRT 


FIND THE SQUARE ROOT 
REMOVE "#" TO GET NEAT SOUNDS 
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INC NUMBER 
BNE .1 WRAPPED 7? 
INC NUMBER+1 
BNE DONE 65536 ? 
INC $7F7 
DEC TEN.TIMES 
BNE .1 
LDA $C058 STOP TIMER 
RTS 
SQRT 
cy #$40 VALUE ALREADY NORMALIZED? 
#---ARG = $4000... FFFF----------- 49152 CASES 
CPX #$FF CHECK FOR ARG-HI = $FF 
BEQ .9 ...YES, SPECIAL CASE 
LDY ROOT,X GET ROOT, USE AS INDEX 
CMP TABLE2,Y 
BCC .1 ... SPEEDS UP AVERAGE BY 0.8 CYCLE 
TXA ARG-HI 
SBC TABLE3,Y 
BCC .1 
INY 
1 RTS 
#---ARG = $0000... 3FFF----------- 
22 STX ARGSAV+1 SAVE ARG-HI 
CPX #0 IS ARG-HI ZERO? 
BEQ .7 . -YES 
#o--ARG = $O1FF. oe 3F FF SQese = 2e2"< 16128 CASES 
STA ARGSAV. SAVE ARG-LO FOR SHIFTING 
STA ARGLO SAVE ARG-LO FOR LATER COMPARE 
TXA ARG-HI TO A-REG 
LDY #0 START SHIFT COUNT = 0 
3 ASL ARGLO 
ROL 
ASL ARGLO 
ROL 
INY 
CMP #$40 
BCC . 
#---A=NORM-ARG, Y=SHIFT-CNT------ 
y TAX USE NORM-ARG FOR INDEX 
LDA ROOT,X GET ROOT FROM TABLE 
5 LSE HALF ROOT SHIFT-CNT TIMES 
BNE .5 
TAY USE SHIFTED ROOT FOR INDEX NOW 
LDA ARGSAV GET ARG-LO 
CMP TABLE2,Y 
BCC . ...SPEEDS UP AVERAGE BY 0.7 CYCLE 
LDA ARGSAV+1 
SBC TABLE3,Y 
BCC . 
INY 
.6 RTS 
$---ARG = $0000... 00FF----------- 
“7 TAY IS ARG-LO ALSO ZERO? 
BEQ .1 ...YES, SQRT=0 
#---ARG = $0001. OOFF----------- 255 CASES 
STA ARGSAV SAVE ARG-LO FOR LATER COMPARE 
LDY #4 START SHIFT COUNT = 4 
.8 CMP #$40 NORMALIZED YET? 
BCS . .- YES, GET ROOT NOW 
ASL 
ASL 
INY COUNT THE SHIFT 
BNE .8 . . ALWAYS 
#---ARG = $FFXX------------------ 
.9 LDY #$FF 
: RTS 
Zz .EQ #=SQRT 
® PUT TABLES SO NO PAGE CROSSING 
. LBS #4255/256 8256-9464 
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We Make 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 
All new 1984 design incorporates the 
latest in state-of-art LC. technologies. 
Complete 12 bit A/D convener, with an 
accuracy of 0.02%! 


16 single ended channels (single ended 
means that your signals are measured 
against the Apple’s GND.) or 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges, any of the 16 channels can have 
any range al any time. Under program 
control, you can select any of the 
following ranges: + 10 volts, t 5V, 
12.5V, $1.0V, t SOOMV, + 250MV, 

+ 100MV, + SOMV, or t 25MV. 

Very fast conversion (25 micro seconds). 


Analog input resistance greater than 
1,000,000 ohms. 

Laser-trimmed scaling resistors. 

Low power consumption through the 
use of CMOS devices. 

The user connector has +12 and -12 
volts on it so you can power your 
sensors. 

Only elementary programming is 
required to use the A/D. 

@ The entire system is on one standard 
size plug in card that fits neatly inside 
the Apple. 

@ System includes sample programs on 


ak: PRICE $319 
A few applications may include the moni- 
toring of @ flow @ temperature @ humidi- 
ty @ wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mois- 
ture and many more. 
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Measurement And Control Easy! 


A/D & D/A 
A/D & D/A Features: 
Single PC card 
8 channels A/D 
8 channels D/A 
Superfast conversion time 
Very easy programming 
Many analog ranges 
Manual contains sample applications 


A/D SPECIFICATIONS 
0.3% accuracy 
On-board memory 
Fast conversion (.078 MS per channel) 
A/D process totally transparent to 
Apple (looks like memory) 
User programmable input ranges are 
0 to 10 volts, 0 to 5, -Sto +5, -2.5 
to +2.5, -5 to 0, -10 10 0. 
The A/D process takes place on a continuous, 
channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 
D/A SPECIFICATIONS 
@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 
drive 5 MA 
@ D/A process is totally transparent to 
e 


the Apple (just poke the data) 

Fast conversion (.003 MS per channel) 
@ User programmable output ranges are 

0 to 5 volts and 0 to 10 volts 
The D/A section contains 8 digital to analog 
converters, with output butfer amplifiers and 
all intertace logic on a single card. On-c ard 
latches are provided tor each of the eight 
D/A converters. No D/A converter could be 
easier to use. The on-board amplifiers are 
laser-trimmed during manufacture, thereby 
eliminating any requirement tor off-set 


nulling PRICE $199 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed for use with both our A/D converters. This 
board incorporates 8 F.E.T. op-amps, which allow gimost any gain or offset. For example, 
an input signal that varies from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output tor the A/D. 


The signal conditioners outputs are on a high quality 16 pin gold 1.C. socket that 
matches the one on the A/D’s x0 4 simple ribbon ; able connects the two. The signal 
conditioner can be powered by your Apple or from an external supply. 


FEATURES 


@ 45” square tor standard card cage and 4 mounting holes for standard mounting. The 
signal conditioner does not plug into the Apple, it: an be loc ated up to 2) mile away trom 


the A/D. 


@ 22 pin .156 spac ing edge card input connector (extra Connectors are easily available ie. 


Radio Shack). 
@ Large bread board area. 
@ Full detailed schematic included. 


@ Provides 4, 8-Bit programmable 1/O 
Ports 


@ Any of the 4 ports can be pro- 
grammed as an input of an output 
port 


@ All I/O lines are TTL (0-5 volt 
compatible 


PRICE $79 


/O 32 


@ Your inputs can be anything from 
high speed logic to simple switches 


@ Programming is made very easy by 
powerful on-board firmware 


@ The I/O 32 is your best choice for any 
control application 


The 1/O manual includes many programs for inputs and outputs. 


Some applications include: 


Burglar alarm, diection sensing use with relays to tum on fights, sound buzzers, stat 
Motog, Control tape cecorders and printers, use with digital joystick. 


PRICE $89 


Please see our other tull page ad in this magazine tor intormston on Applied Engineering's Timemaster Clock Card and other products for the Apple 
Our boards are far superior to most of the consumer electronics made today. AIL C.’s are in high quality sockets with mil-spec. Components used throughout. P.C. boards are glass- epoxy 
with gold contacts. Made in America to be the best in the world. All products Compatible with Apple Ih and //e. 


Applied Engineering's products are fully tested with complete documentation and available tor immediate delivery. All products are guaranteed with a no hassle three year warranty. 
Send Check oF Money Order to: 
APPLIED ENGINEERING 
P.O. Box 798 
Carroliton, TX 75006 


Texas Residents Add 5% Sales Tax 
Add $10.00 !{ Outside U.S.A. 
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New ProDOS Bug and Fix 


The November 1986 issue of Open-Apple (Tom Weishaar's wonderful 
newsletter) tells of an important new discovery. For about a 
year Tom has been reporting on the symptom: Appleworks and 
Applewriter data disks suddenly turning up with track 0 
destroyed. It only happened to 5.25" diskettes, and only one 
certain machines, and otherwise seemingly at random. For a 
complete description, get all of Tom's back issues. 


Some of his readers from Australia seem to have tracked down 
the problem, and they suggest a solution. In the floppy driver 
code inside ProDOS, at $D6C3, there are four STA commands that 
turn off all four stepper motor windings. Tom says the purpose 
is to disable any 3.5" drives connected in a daisy chain to the 
same controller. I wonder, because this code has been here 
since 1983, long before the possiblility of 3.5" drives. 
Anyway, the code has a bad side-effect in some systems. 


A quirk of the controller card is that STA operations to the 
stepper motor winding soft-switches also cause the card to 
write on the data bus. So you have the bus being driven in two 
directions at once: the cpu trying to store the A-register, 
and the controller card trying to send something meaningless. 
Besides resulting in garbage on the data bus, which causes no 
real damage in this case, apparently in some Apples with some 
controller cards it causes the card to go into WRITE mode. 
Whatever track the head is sitting on will then be clobbered. 


The solution is to change the four STA operations to LDA. The 
disk drives will get the same message, without causing the bus 
contention. You can patch the PRODOS system file and re-SAVE 
it, on all your disks. If you have a hard disk, you should 
Only have to do it one time. If you BLOAD the PRODOS file at 
$2000, the four instructions will be found at $56D3: 


56D3: 9D 80 CO STA $C080,X 
56D6: 9D 82 CO STA §$C082,xX 
56D9: 9D 84 CO STA §$C084,xX 
56DC: 9D 86 CO STA $C086,X 


If you change all those "9D" bytes to “BD", which is the opcode 
for “LDA addr,X"“, the bug is supposed to disappear. Doing it 
from inside the S-C Macro Assembler, I did it this way: 


:BLOAD PRODOS,TSYS,A$2000 

sUNLOCK PRODOS 

:$56D3:BD N 56D6:BD N 56D9:BD N 56DC:BD 
:BSAVE PRODOS, TSYS,A$2000,L14848 

:LOCK PRODOS 


I personally have never had ProDOS clobber a diskette. I have 
trashed some myself, by stupidity, but this hardware/software 
bug has never caused it. Nevertheless, I have now patched my 
disks, just in case. Many thanks to Tom, Open-Apple, and to 
the men in Australia. 
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NEW!!! JT INAMAC: $69.00 
This Apple I! emulator runs DOS 3.3 and PRODOS programs (including 6502 machine language routines) on a 512K 
Macintosh. All Apple || features are supported such as HI-RES/LO-RES graphics, 40/80 column text screens, 
language card and joystick. Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk 
accessories and support for 4 logical disk drives. Package includes 2 MAC diskettes (PROGRAM holds emulation, 
communications and utility software, DATA holds DOS 3.3 and PRODOS system masters, including Applesoft and 
Integer BASIC) and | Apple II diskette (transfer software moves disk images to the MAC). 


NEW ! 1! SCREENGEN: $35.00 
Develop HI-RES screens for your Apple |i on a Macintosh. Don't be limited by MousePaint or other screen 
editors. Use MACPAINT (or any other application) on the MAC to create your Apple Il screen. Then use 
SCREEN.GEN to transfer directly from the MAC to the Apple |! (with SuperSerial card or equivalent). Package 
includes Apple || diskette with transfer software plus fully commented SOURCE code. 


NEW !!! MIDI-MAGIC for Apple //c: $49.00 
Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MiDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple Il family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special printer functions (like expanded, compressed etc.) 
supported. HIRES screen editor lets you create your own characters and special graphics symbols. For Apple Ii, 
i+, //e. Specify printer: Apple Dot Matrix, C.ltoh 8S 10A (Prowriter), Epson FX 80/100, or OkiData 92/93. 

* The Font Downloader & Editor for the Apple Imegewriter Printer. For use with Apple Il, 
li+, //e (with SuperSerial card) and the Apple //c (with builtin serial interface). 

* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembler to investigate the inner workings of Apple || machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables, displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 
Converts a ‘dumb’ parallel printer 1/F card Into a ‘smart’ one. Command menu eliminates need to remember 
complicated ESC codes. Features include perforation skip, auto page numbering with date & title. Includes large 
HIRES graphics & text screen dumps. Specify printer: MX-80 with Graftrax-G0, MX-100, MX-80/100 with 
Graftraxplus, NEC 6092A, C.ltoh 8510 (Prowriter), OkiData 82A/63A with Okigraph & OkiData 92/93. 
‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation’s Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, audible ring detect. ring-back, printer buffer, 60 col card & shift key mod support. 
RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-suppliad 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnO0O-CnFF and $CG00-CFFF. 
C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c. C-PRINT plugs into the standard Apple //c printer serial 
port and into any printer having a standard 36 pin centronics-type parallel connector. Just plug in and print! 


Unless otherwise specified, all Apple II diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
SEECECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
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Timing Apple Programs with Another Apple...... 
--eBob Sander-Cederlof 


While I was working on Charles Putney's integer square root 
program, I longed for a better way to time it. I was wasting a 
lot of my time using a stopwatch, and still getting inaccurate 
(or at least imprecise) times. 


For around $3000 I could buy a logic analyzer and hook it up to 
count machine cycles. That is obviously out of the question. 
Maybe I could hunt around among my old boards and find one with 
a 6522 on it: that chip has an interval timer that could give 
me fairly accurate times. I might be able to find one, but 
then I would have to figure out how to program it again. 


Then I thought about using the game port to communicate with 
another Apple, and put a timing loop in the other Apple. I 
hooked one of the Annunciator output lines in my first Apple to 
a Push Button input line on the second one. Then I set up the 
program being clocked to set the annunciator on at the 
beginning and turn it off at the end. I wrote a timing program 
to run in the other Apple which waited until the push button 
input went on, and then counted loops until it went low again. 
The results were better than I hoped for! 


To hook up the Apples, I started by finding some wire. I 
needed about 12 feet of at least two wires. I found about six 
feet of four-line telephone wire, and another six feet of 
twisted pair left over from my burglar alarm installation. I 
connect them together, very crudely, and stretched them across 
the room. The Apple on the south side of the room is my 
nine-year-old. It has a nice ZIF-socket in the game port, so I 
inserted the ground wire into pin 8 and the signal wire into 
pin 2, and clamped the socket. If you do not have a ZIF socket 
in yours, the telephone wire fits very nicely into the holes in 
a regular socket. 


The Apple //e on the north side of the room challenged me a 
little more. First, the game socket is unreachable, way under 
the top right lip of the upper case. I can't even see it 
without a flashlight! There is a nine-pin D-connector on the 
back panel, but the Annunciator lines do not come to this 
connector. A little research led to the knowledge that the 
Annunciator signals come directly from pins 10-13 of the IOU 
chip. I chose ANO, which is pin 10. I hooked a red miniclip 
lead to that pin, and a black miniclip lead to ground at pin l 
of the same chip. The IOU chip is the 40-pin chip at position 
E5 on my //e motherboard, conveniently labeled "IOU". Facing 
the computer from the front, pin one is the first one on the 
right-hand side of the chip. Pin 10 is on the same side, about 
half way back. I then connected the other end of those leads 
to my wires, and the circuit was complete. 


The program in the //e is the program whose time I want to 
measure. At the beginning of the section to be timed, I insert 
the instruction "LDA $C059" to turn on ANO. At the end, I 
insert the instruction “LDA $C058" to turn off ANO. 
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RamWorks III 


Patented Performance from the Recognized Leader 


With battery backed RAM port RGB port, increased memory capacity, full software 
compatibility and more compact design, RamWorks III is a generation ahead 


RamWorks Ill is the newest 3rd 
generation RAM card for the Apple Ile. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease Of use. A design so advanced it’s 
patented. We call it RamWorks IIL you'll 
call it awesome! 


The AppleWorks Amplifier. 

While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
Offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks III to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and only RamWorks III 
does. With a 256K or larger RamWorks 
II, all of AppleWorks (including printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 
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Only RamWorks eliminates Apple- 
Works’ intemal memory limits, increasing 
the maximum number of records avail 
able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 
from 2,250 to over 15,000. And only 
RamWorks offers a built-in printer buffer, 
so you won't have to wait for your 
printer to stop before returning to Apple- 
Works. RamWorks even expands the 


clipboard. And auto segments large files 


, so they can be saved on two or more 


disks. You can even have Pinpoint or 
MacroWorks and your favorite spelling 
checker in RAM for instant response. 
RamWorks, nothing comes close to 
enhancing AppleWorks so much. 


The Most Friendly, Most 
Compatible Card Available. 


Using RamWorks III couldn't be easier 
because its compatible with more off 
the-shelf software than any other RAM 
card Popular programs like AppleWorks, 
Pinpoint, Catalyst, MouseDesk, Howard- 
Soft, FlashCalc, Pro-Filer, Managing Your 
Money, SuperCalc 3a, and MagiCalc to 
name a few (and afl hardware add on’s 
like ProFile and Sider hard disks). Ram- 
Works is even compatible with software 
written for Apple cards. But unlike other 
cards, RamWorks plugs into the Ile 
auxiliary slot providing our super sharp 
80 column text (U.S. Patent #4601081) in 
a completely integrated system while 
leaving expansion slots 1 through 7 
available for other peripheral cards. 

RamWorks III is compatible with all 
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| Apple Ile’s, enhanced, unenhanced, 


American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of 
fered the largest memory for the Ile and 
RamWorks III continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)..but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works III by plugging into the industy’s 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 

If you've got some other RAM card 
thats not being recognized by your 
programs, and you want RamWorks IIL 
you're in luck Because all you have to 
do is plug the memory chips from your 
Current card into the expansion sockets 
on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don't need RGB and for those that 
do. Because if you don’t need RGB 
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| Applied Engineering doesn’t make you 


: Endorsed by the Experts. 
buy it, but if you want RGB output 


coverage no matter where you | 
purchase 


you're in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most 
claim is the best they have ever seen. 
You'll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB 
option is more than just the ultimate in 
color output because unlike others, it's 
fully compatible with all the Apple 
standards for RGB output control, mak- 
ing it more compatible with off-the-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
option provides both Apple standard and 
IBM standard RGB outputs (cables in- 
dluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- 


RGB Option 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 16 Bit Power. 

RamWorks III has a builtin 65C816 
CPU port for direct connection to our 
optional 65C816 card. The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3™ 
compatible program, VIP Professional. 
Our 65C816 card does not use another 
slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 
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A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks...I 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “RamWorks is the most 


‘T wanted a 
memory card for 
my Apple that was 
fast, easy to use, 
and very compat. 


_ ible; so I bought 
~ RamWorks.” 


Steve Wozniak, the creator 
of Apple Computer 


powerful auxiliary slot memory card 
available for your Ile, and J rate it four 
stars...For my money, Applied Engineer- 
ing’s RamWorks is king of the hill” 
Apple experts everywhere are im- 
pressed by RamWorks's expandability, 
versatility, ease of use, and the sheer 


power and speed that it adds to any Ie. 
With a RamWorks in your Apple, you'll 
make IBM PC's and ATs look like 


slowpokes. 


Quality and Support of the 
Industry Leader 

RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of large RAM cards for the 
Apple. With our 5 year no hassle 
warranty and outstanding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


Its Got It All 


e 15 day money back guarantee 
e 5 year hassle free warranty insures 
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e Built-in super sharp 80 column display, | 
(US. Patent #4601081) 

e Expandable to 1 MEG on main card 

e Expandable to 16 meg with expander 
cards, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

e Automatic AppleWorks expansion up 
to 3017K desktop 

e Accelerates AppleWorks 

e Built-in AppleWorks printer buffer 

e The only large RAM card that’s 100% 
compatible with all fle software 

e RamDrive™ the ultimate disk emula- 
tion software included free 

e Memory is easily partitioned allowing 
many programs in memory at once 

e Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 

e Built-in self diagnostics software 

e Lowest power consumption (U.S. 
Patent #4601081) 

e Takes only one slot (auxiliary) even 
when fully expanded 

e Socketed and user upgradeable 

e Software industry standard 

e Advanced Computer Aided Design 

e Used by Apple Computer, Steve 
Wozniak and virtually all software 
companies 

e Displays date and time on the Apple 
Works screen with any PRO-DOS 
compatible clock 

e Much, much more! 


RamWorks Ill with 64K 
RamWorks Ill with 256K 
RamWorks Ill with 512K 
RamWorks lil with 1 MEG 
RamWorks lil with 1.5 MEG 


$179 
$219 
$269 
$369 
$539 


RamWorks ill with2to16MEG CALL 


65C816 16 Bit Card 
RGB Option 
Optional Software: 
Pinpoint with RAM 
Enhancement Software $79 
VIP Professional $219 


RamWorks II]. The industry standard 
for memory expansion of the Apple Ile. 

ORDER YOUR RamWorks III TODAY. 
9 am. to 11 p.m 7 days, or send check 
or money order to Applied Engineering. 

MasterCard, Visa and CO.D. welcome. 
Texas residents add 5%% sales tax. Add 
$10.00 if outside US.A 


$159 
$129 


= Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 
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The timing program in the other Apple is shown below. Lines 
1130-1180 set up a page zero location to contain $01, which I 
need later to make all the timing correct. They also clear the 
three registers, which I am going to use for accumlating a 
24-bit count. Lines 1190-1200 then wait until the input signal 
goes high. This will happen when the program in the //e does 
the "LDA $C059" instruction. 


Lines 1260-1400 increment the 24-bit count once each 20 cycles, 
until the PBO signal falls. The signal is tested only once 
each 20 cycles, so there is a built in resolution of 20 cycles. 
If I want to measure a program down to the exact cycle, I will 
have to run it at least 20 times. Actually, there are two 
other sources of “error“: the signal on my 12 feet of wire 
will not necessarily rise and fall at exactly the same speed; 
and the two Apples may not be running at exactly the same 
speed. 


The various paths in lines 1260-1400 are all carefully timed so 
they all take exactly 20 cycles. The interval between BIT PBO 
executions should always be 20 cycles. Of course, that is, 
unless I made a mistake. There is one exception: When the 
A-register wraps around, after 16,777,216 counts, lines 
1340-1350 add 5 cycles. The total interval on this path is 24 
cycles. But this only happens once every 6 or 7 minutes, so 
who cares! 


Finally, lines 1420-1490 print out the resulting count in 
hexadecimal. I then take my handy Radio Shack calculator out, 
convert to decimal, multiply by 20, and have the cycle count. 


I like this arrangement so well, and I need to time programs so 
frequently, that I plan to make a more permanent hookup. And 
that reminds me of an old idea... a way to network several 
Apples using just the gameport.... 


0 
1020 # START COUNT WHEN PBO (OPEN-APPLE) 


10 9 * PRESSED, STOP WHEN RELEASED 

00- 1050 CNTO .EQ 0 

01- 1060 CNT1 <:EQ 1 

02- 1070 CNT2 .EQ 2 

03- 1080 ONE .EQ 3 
1000: Becesewec sa te eso bee 

C06 1- 1100 PBO «EQ $C061_— BIT 7 = 1 WHEN PRESSED 
1120 T 

0800- AO 01 1130 LDY #1 

0802- 84 03 1140 STY ONE 

0804- 88 1150 DEY Y=0 

0805- 98 1160 TYA A=0 

O806- AA 1170 TAX X=0 

0807- 18 1180 CLC 

0808- 2C 61 CO 1190 .1 BIT PBO 

O80B- 10 FB 1200 : BPL .1 
1220 ® 20 CYCLES PER LOOP, REGARDLESS OF PATH 
1230 & 24-BIT COUNTER GIVES 16,777,216 COUNTS 
129 * WHICH IS 335,544,320 CYCLES 

O80D- 2C 61 CO 1260 .2 BIT PBO 

0810- 10 1 1270 BPL .5 END OF COUNTING 

0812- E8 1280 INX 

0813- DO OA ~—-1290 BNE .3 

0815- C8 1300 INY 
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DO 1310 . 
0818- 65 03 1320 ADC ONE 
O81A- DO F1 1330 BNE .2 
081C- 18 1340 CLC 
081D- 90 EE 1320 P BCC .2 
O81F- EA 1310 3 NOP 
0820- EA 1380 NOP 
0821- EA 13 . NOP 
0822= DO E9 ac i BNE .2 
O824- 85 02 1420 .5 STA CNT2 
0838- 86 00 140 Stx NTC 
O82A- 20 DA FD Ue JSR $FDDA 
O82D- A5 01 1460 LDA CNT1 
0832-45 00 1460 LDA CNTO. 
0834- 4C DA FD 1490 JMP $FDDA 

1500 Sennen nn nnn nn nen nnn nnn nen nnne== 


The //gs Reference Manuals 


When Apple sent me the prototype //gs they included ll fat 
3-ring binders full of documentation. Much of it is destined 
to eventually be published as reference manuals by 
Addison-Wesley. I can hardly wait, because in the present form 
it is incomplete, inconvenient, inconsistent, inaccurate, and 
takes up too much space. I am sure the finished product will 
be up to Apple's usual standard, eliminating all the negatives 
just mentioned. 


Addison-Wesley has released a little folder which describes the 
new manuals, with projected publishing dates. We will carry 
some of these, as soon as they are available. 


The first book out will be “Technical Introduction to the Apple 
//ags". It is due in December, but there is not much REAL 
information in it. It is more like a complete marketing 
description, without the kind of detailed information 
programmers need. It is only 120 pages. 


Three books are due in "Spring, 1987". I suppose that means we 
can expect copies by June 21st, at least. These look like 
books worth ordering: 


“Programmer's Introduction to the Apple //gs", 
150 pgs, $19.95 

"Apple //gs Hardware Reference", 250 pgs, $26.95 

"Apple //gs Firmware Reference", 250 pgs, $24.95 


Three more are due in “Summer, 1987", which means no later than 
September 2lst: 


“Apple //gs Toolbox Reference" 
Volume 1, 400 pgs, $29.95 
Volume 2, 400 pgs, $29.95 

“Apple //gs ProDOS 16 Reference" 
Disk included, 200 pgs, $39.95 


I expect Gary Little's new book, “Inside the Apple //gs", to be 
coming out by next March or April. No doubt there will be many 
more books coming out. Apple has a way of triggering whole new 
industries.... 
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PAUSE Directive for S-C Macro Assembler 2.0.........Bill Morgan 


Many times we want to call "time out" during an assembly, tor 
various reasons. Maybe a program has outgrown the available 
disk space and we need to swap source disks, or maybe we need 
to check the value of a label during assembly. We can't 
manually pause an assembly at a specific place during pass one, 
and it's difficult to do during pass two if the listing is on, 
Since you have to sit and stare at the screen to tell where the 
assembly is. What we need is a PAUSE directive to tell the 
assembler to stop and wait for a keypress before continuing. 


Back in May of 1983 Mike Laumer wrote up such a directive for 
the S-C Macro Assembler. The Assembler provides a .US 
directive for just such cases and Mike supplied the routines to 
use a line like .US SWAP SOURCE DISK to pause the assembly and 
display “SWAP SOURCE DISK" on the screen in inverse text. The 
Macro Assembler, Apple computers, and people's expectations 
have all changed in the last 3 1/2 years, so it seems like time 
to update and expand that article. 


The .US vector normally contains JMP CMNT, a jump to the 
assembler's comment routine to just list a line. We can patch 
in the address of our handler and then have our code exit to 
CMNT when we're through. When control transfers to the .US 
vector the source line is in the system input buffer at $200 
and location $7B contains an index into the buffer, pointing at 
the first character following the ".US“ (normally a space). 
Another assembler variable that can come in handy for a .US 
feature is PASS, at $60. This location contains a 0 during 
pass one of assembly and a 1 during pass two. 


It only takes a few changes to adapt Mike's code to the Version 
2.0 Macro Assemblers. The .US vector is now at $D015 ($8015 
for ProDOS), so we have to change that .EQuate line. CMNT has 
shifted around between various releases of Version 2.0, so I 
redid the code in INSTALL to transfer the correct address for 
CMNT out of the vector before installing PAUSE. 


We only need to make two more changes to create a PropDOS 
version: alter the .US vector definition as shown in lines 
1230-1240; and delete lines 1180-1190, 1290-1300, and 1400, 
since we don't need to worry about enabling/disabline the 
“Language Card“ memory under the ProDOS assembler. 


Most of the changes have to do with accomodating the //e 80- 
column display, with its division between main and auxiliary 
memory. I kept the technique of uSing the Y-register to index 
through the source line, and the X-register to index through 
screen memory. Toggling the Carry bit keeps track of which 
bank we need to store into, and incrementing Y after each store 
and incrementing and testing X after every other store takes 
care of the different indexes we need. 


I thought we were just about done when I realized that this 
program wouldn't properly handle lower case text in the message 
string. To use inverse lower case we have to take the AltChar 
soft switch into account and adjust the ASCII values. I added 
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With the TransWarp™ accelerator, your ITe™ or IT+"™ 
is 40% faster than the IIcs! 


Computing at warp speed! 

Its an experience vou shoulda t miss. And with ‘TransWarp. 
vou wont have to. Because TransWarp will rua vour He or 
I+ software 3.6 times faster thats 0% faster than 
Apple's Has’ 

No more vawning while vour Apple slowly: rearranges 
text or calculates spreadsheets. With 250K of ultra-iist RAM, 
‘TransWarp speeds up aff Apple software including Apple: 
Works, and all educational software, graphics and games, And 


its compatible with all standard peripheral cards (such as Ram- 


Works and Apple memory carcds), hard disks, 312" UniDisks, 
80-column cards, modems, clock cards, mouses and more! You 


name it, TransWarp accelerates it There's even a 16 bit upgrade 


chip available. 


“TransWarp ts great! I bave 
replaced all my otber 
accelerators with it!” 


Steve Wozniak, the creator 
of Apple Computer 


An important difference. 


With TransWarp, software runs up to three times faster than 
with other cards, since the others cant accelerate programs in 
auxiliary memon: Thats why ‘TransWarp is so much faster than 
the rest. Nearly all of today’s more powerful programs run par: 
tially or Completely in auxiliary memory: programs like Apple: 
Works, Pinpoint, Managing Your Money, SuperCale 3a, BPE and 
Pascal, to name afew. Why settle fora card that accelerate, 
only part of the memory? 

There's one more important difference. Since TransWarp 
doesnt use memory caching, vou get consistent high speed 
performance. 

A cinch to use. 


Simply plug TransWarp into apy slot in vour Apple H. TP+ or 
He — including slot 3 in the He. Instantly vou ll be computing 
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at speeds vou only dreamed about before. And should you 
ever wish to run at normal speed, simply press the ESC kev 
while turning vour Apple on. 

Since ‘TransWarp is completely transparent, vou wort need 
preboot disks or special software. [ts ready to go right out of 
the package! 

Speed = Productivity 

Imagine the productivity gains voull achieve when vour 
programs are running over dirce times faster, TransWarp is so 
powerful, vour Apple will make [BM PCs™ and even APS™ 
look like slowpokes. 

* 3.0 MHZ 05CO2 * Totally transparent operation 
* 250K of ultra-fast on-board with all software 
RAM * Plugs into any slot, including 
* Accelerates main aid slot 3 on the Apple He 
dunxiliarny memory ° Accelerated 16 bit option 
* Low power consumption for available 
cool operation °S-vear Warranty 
Satisfaction guaranteed! 

Give your Apple the TransWarp advantage. With our risk-free 
15-day monev back guarantee, vou have nothing to lose but 
wasted time. Call today! 


TransWarp accelerator $279 
16 bit upgrade (may add kiter) $89 
For fast response: 

Call Applied Engineering, 9 aim. to TE p.m. 7 chavs at (214) 
241-6000. MasterCard, VISA ancl C.O.D. welcome. ‘Texas resi- 
dents add S's% sales tux. Addl $10.00 if outside UIS.A Or mietil 
check or money order to Applicd Engineering, PO. Box 798, 
Carrollton, TX 75006, 


Va. wa Applied Engineering 
The Apple enbancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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that code in at the last minute, and left it with odd line 
numbers and lower case opcodes, so you can see exactly how much 
extra effort it takes to deal with inverse lower case. If 
you're always going to use upper case text in your Pause 
messages you can save 24 bytes by leaving out those lines. 


This program is specifically for the Apple //e 80-column 
display. For 40-column display you can just change the 
addresses in Mike's original article. For other 80-column 
displays you will probably have to give up some transparency, 
Since you are unlikely to be able to display something on the 
screen without going through the usual I/O hooks. Maybe you 
can store directly into the card's memory, if the manufacturer 
documents how to do it. 


Lee SAVE S.NEW. PAUSE 
taeo : -US DIRECTIVE TO PAUSE DURING ASSEMBLY 
1080 # SYNTAX: .US <phrase> 
1050 # RESULT: preplays <phrase> in inverse text 
ee : and waits for a keypress 
1080 #.~-.- eo ee ee 
TB- 1090 CHAR.PTR .EQ $7B 
0200- 1110 WBUF ~EQ $200 
O7D0- e6 CORNER ~EQ $7D0 
CO00- iibo KEYBOARD .EQ $C000 
COOE- 1141 alt.off -.eq $c00e 
COOF~ 1142 alt.on : coor 
C010= 1150 STROBE "Ed C010 
CO1E- ee alt.read .e cOle 
CO54- 1160 PAGE1 ~-EQ $C054 
C055- he PAGE2 ~EQ $C055 
C080- 1180 PROTECT .EQ $C080 
C08 3- NG ENABLE ~EQ $C083 
FBE2- sooo BELL -EQ $FBE2 
D0O15= oho USR.VECT .EQ $3012 DOS 3.3 
1240 # 8015 ProDOS 
1250 #-------~---------+-------------- 
1260 -OR $300 
i210 
1280 INSTALL 
0300- AD 83 CO 1290 LDA ENABLE write enable 
0303- AD 83 CO 1300 LDA ENABLE RAM card 
0300—- A2 01 1310 LDX #1 start with hi-bytes 
0308 BD 16 DO 1340 | LDA USR.VECT+1,X get SC.CMNT address 
O30B- 48 1 ie PHA stash it 
030C- BD 65 03 1340 LDA EXIT+1,X get PAUSE address 
030F- 9D 16 DO 1390 STA USR.VECT+1.X set .US vector 
0312- 68 1360 PLA recover stash 
0313- 9D 65 03 1310 STA EXIT+1.X set exit address 
0316—- CA 1380 DEX now do lo-bytes 
0317= 10 EF 130 BPL .1 
0319= AD 80 CO 1400 LDA PROTECT protect card 
031C= 60 1410 RTS 
1420 #--~-------~~--.---------- 
031D- A2 00 Mie PAUSE LDX #0 start at beginning of screen line 
O31F- 18 1440 CLC clear toggle 
0320- AD 1E CO 1441 lda alt.read get altchar status 
0323- 08 1442 php Stash it 
0324- 8D OF CO Mies sta alt.on altchars on 
0327- AX 7B 145 LDY CHAR. PTR index into source line 
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0329- B9 00 02 1460 .1 LDA WBUF,Y get char from call line 
032C- FO 22 1470 BEQ .3 -EQ. is end of line 

032E- 08 1471 php : preserve carry 

032F- C9 60 vide cmp #' ' test for lower case 

0331- 29 3F 1480 AND #%00111111 invert char 

0333- 90 02 1481 bee . .CC. if upper case 

0335- 09 40 1482 ora #%01000000 correct inverse lower case 
0337- 2 1483 .15 pi restore carry 

0338- BO OA Maan CS a2 branch if odd screen position 
033A- 8D 55 CO 1510 STA PAGE2 even, sO use aux memory 
033D- 9D DO O7 1520 STA CORNER ,X show character 

0340- C8 1530 INY next message character 
0341- 38 1540 SEC set toggle 

0342- BO E5 2 : BCS .1 always 

O344- 8D 54 CO 1570 .2 STA PAGE1 odd, so use main memory 
0347- 9D DO O07 1580 STA CORNER ,X show character 

O34A- C8 19 30 INY next message character 
O34B- E8 1600 INX next screen position 

034C- EO 28 1610 CPX #40 line full? 

O34E- 90 D9 ae BCC .1 no, get another char, clear toggle 
0350- 20 E2 FB 16h 3 JSR BELL beep 

0353- AD 00 CO 1650 . LDA KEYBOARD 

0356- 10 FB 1660 BPL .4 wait for keypress 

0358- 8D 10 CO 1670 STA STROBE 

035B- 8D OE CO 1671 sta alt.off assume altchars off 

035E- 28 1672 p get altchar status 

035F- 10 03 1673 pl exit -PL. if altchar was off 
0361- 8D OF CO OTF sta alt.on set altchars on 

0364- 4C 1D 03 5G EXIT JMP PAUSE address modified by INSTALL 


ACCEPT NO SUBSTITUTES. 
BECAUSE THERE AREN’T ANY. 


Ties only one card like RamWorks. We've got the best hardware 
design. We supply the best software and we’ve got the best support from 
software companies. 


If someone tempts you with an imitation, please get both sides of the 
story. You'll discover why RamWorks offers the best enhancements to 
AppleWorks and other programs, and at the lowest price. 


GUARANTEED! 


214-241-6060 AR 


“We Set the Standard”’ 
9 AM - 11 PM APPLIED ENGINEERING 
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//gs Battery RAM and Clock/Calendar.......Bob Sander-Cederlof 


There are 256 bytes of RAM inside the clock chip in the Apple 
//gs. These bytes are backed up by the same battery that keeps 
the clock ticking when you turn off your Apple. You can read 
and write the battery RAM locations, but not the same as 
regular RAM. You can either do it the hard way, by direct 
hardware, or you can do it through the built-in firmware. 


First, the easy way. When you turn on your //gs, the power-up 
routines install a lot of stuff in RAM in banks SEO and SEl. 

At the beginning of SEl there are a lot of JMP opcodes, with 
long (24-bit) addresses. The one at $E10000 is a jump to the 
Tool Locater. The Tool Locater is simply a way to access a lot 
of firmware subroutines without knowing their actual addresses. 
Instead of calling a firmware subroutine directly, you load up 
a subroutine number in a register and call the single known 
address, $E10000. 


To keep things organized, the //gs firmware designers require 
you to call $E10000 with the 65816 in Native mode, with a JSL 
SE10000. Any parameters the subroutines need must be pushed 
onto the stack before the JSL, and any results will be on the 
stack when the subroutine is finished. The carry status will 
indicate whether the subroutine returned an error code or not, 
just as in ProDOS MLI. If carry is clear, there was no error; 
if carry is set, there was an error and the error code is in 
the A-register. Regardless of the setting of the m- and x- 
status bits when you call $E10000, it will return with both of 
them zero (full 16-bit mode). 


You tell the Tool Locater which “tool” to call by a code number 
in the X-register. This is a 16-bit value, so you must have 
16-bit mode on for the X-register when you call $E10000 
(x-status bit=0). It doesn't matter whether m-status is 0 or 
1. The tool code is made up of a tool set number (00-FF, in 
the low byte) and a tool number (00-FF, in the high byte). The 
tool code to read all 256 bytes of battery RAM is $0A03; to 
write 256 bytes out to battery RAM, the tool code is $0903. 

The following program will read battery RAM: 


1020 OP 65816 
1030 #---nn nnn nn nnn nnn nnn wenn nen == 
000800- 18 1040 R CLC 
000801- FB 1050 XCE 
000802- C2 30 . : . REP #$30 
OO00804- F4 00 00 1080 PEA BUF/256/256 
000807- F4 00 09 1090 PEA BUF 
OOO80A- A2 0 1100 LDX ##$0A03 READ BATTERY RAM 
OO0O080D- 22 00 00 E1 oc ; JSL $E10000 
000811- 38 Re SEC 
000812- FB 1140 XCE 
000813- 60 1150 RTS 
1160 #q------- een nnn nnn nnn nnn nnn a= 
0008 14- 18 ho W CLC 
000815- FB 1180 XCE 
000816- C2 30 Maa : REP #$30 
000818- F4 00 00 1210 PEA BUF/256/256 
00081B- F4 00 09 1220 PEA BUF 
OOO81E- A2 o3 09 ho LDX th teat WRITE BATTERY RAM 
000821- 22 00 00 E1 1560 JSL $E10000 
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Save Time Debugging Your 
Assembly Language Programs 
With QUICK TRACY 


Now you can whiz out your assembly language programs even faster than before with 
QUICK TRACY. This new debugger was "just the thing Bill needed while working on 
the UniDisk boot program", in the July 1986 issue of Apple Assembly Line. QUICK 
TRACY will rapidly trace through your machine language object code, suggesting the 
execution of JSR instructions in real-time. Even though QUICK TRACY suggests, you 
are in complete control at all times. QUICK TRACY extends the S-C Macro Assembler 
by providing you with 27 powerful debugging commands. Whether you have the DOS 
3.3 version or the ProDOS version, QUICK TRACY can do the job for you. Whether 
you have an Apple //e or Apple J[+ in 40 or 80 columns, QUICK TRACY can do the 
job for you. QUICK TRACY can execute those parts of your program at real-time that 
you know are okay, while carefully tracing and displaying all registers and flags for each 
instruction in those areas of your program that you designate. QUICK TRACY has 13 
independent conditional breakpoints that you may set to SPELL OUT TROUBLE. One 
major advantage is that QUICK TRACY is located in memory with the S-C Macro 
Assembler; so as soon as you finish assembling your program, it is ready for QUICK 
TRACY to help you find the bugs. Let’s face it. Even the very best programmers get 
bugs, and they have debuggers for their hardware. Now here is one specifically designed 
for your hardware and software needs. 


Why are you wasting your valuable time debugging when you could have QUICK 
TRACY doing that tedious work for you? 


QUICK TRACY is available in either DOS or ProDOS for only $35.00 
(or both versions for only $55.00). 


T’n’T SOFTWARE 

624 Charmain Drive 

Campbell, CA 95008 
(408) 378-8358 


We Accept Visa or MasterCard. 


For Postage and Handling, please include $2.00 if U.S., $5.00 for all other countries. 
California state residents, please include applicable sales tax. 


QUICK TRACY requires S-C Macro Assembler version 2.0, DOS 3.3, or ProDOS, 
Apple J[+ or Apple //e, at least 64K of RAM, printer and disk drive. 


"Apple" is a registered trademark of Apple Computer, Inc. 
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With the 
7-80 Plus, run 
over 5000 new 

CP/M’ programs. 


Now, get two computers 
in one, and all the 
advantages of both 


nter the CP/M word with the new 2-80 Plus card from 

Applied Engineering, and introduce your Apple Ile, Ics or 
II+ to thousands of CP/M programs. Only the 7-80 Plus comes 
standard with the new 5.1 software, the most advanced system 
ever for running CP/M programs. 

The new 5.1 boasts advanced features like built-in disk 
emulation for popular memory expansion boards, boosting both 
system speed and storage capacity. And menu-driven utilities that 
let you get to work faster. The Z-80 Plus also lets you run older 
CP/M programs-—-all the way down to Version 1.6 (2.2 is the 
most popular). 

The 7-80 Plus is the only card on the market capable of 
accessing more than 64K. If you have an extended 80-column 
card, all 128K is usable. And if you have RamWorks, RamFactor, 
GsRam, GsRam Plus, or an Apple memory card in your IIe, Hes or 
ll+, up to 1088K is available. 

Each Z-80 Plus comes with our CP/M Ram Drive software, 
enabling most memory cards to work as a high-speed Ram disk 
so CP/M software can run up to feenh: times faster. So packages 
like WordStar, dBASE II, Turbo Pascal and most others run at 
blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll 
get the benefits of two computers in one—all at an unbelievably 
low price (only $149!). 


e Fully compatible with ALL CP/M software —e Fully compatible 
with 5%” and 3%" disk drives as well as most hard disks includ- 
ing the Sider =e Fully compatible with Microsoft disks (no pre- 
boot required) —¢ Specifically designed for high speed opera- 
tion e Runs WordStar, dBASE II, Turbo Pascal, and ALL other 
CP/M software with no pre-boot —e Semi-custom LC. and low 
parts count allows Z-80 Plus to fly through CP/M programs with 
extremely low power consumption (we use the Z-80B) e Does 
EVERYTHING other Z-80 boards do, plus Z-80 interrupts 

® Five-year warranty 


To get your Z-80 Plus or for more information see your 
dealer, or call 214-241-6060 9 a.m. to 11 p.m. seven days, or send 
check or money order to Applied Engineering. MasterCard, VISA 
and C.O.D. welcome. Texas residents add 5%% sales tax. Add 
$10.00 outside U.S.A 


y= Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


CPM is a registered trademark of Digital Research. 
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000825- 38 1260 SEC 


000826- FB 1270 XCE 
000827- 60 1280 RTS 

1290 @seoee 2 one eee eo eee 
0900- 1300 BUF  .EQ $900 

13100 Waseeseseceace saree cokes sese 


When I did this on my //gs prototype, this is what I got: 


0900-00 00 00 
0910-00 00 O07 


OOBO-FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF-..-.- ...-...-.- 


OOFO-FF FF FF FF FF FF FF FF FF FF FF FF 27 CE 8D 64-...-.....-.-.- 'N.d 


Those last four bytes are some kind of a check sum, handled 
automatically by the tool. I suppose that if the checksum is 
incorrect on power up, you will be popped into the configurator 
instead of going into a boot. You can read these bytes, but 
you cannot write them with the tool: the tool will calculate a 
checksum and write it when you write the other 252 bytes. 

Bytes $52 through SFB are either used by the operating system 
Or reserved for the future. Just for fun, I have now written 
my Own name in ASCII code into the bytes starting at SCO. 


The rest of the bytes are used as shown in the following table. 
Where two choices are shown, separated by a slash, the left one 
has a code of $00 and the right choice has a code of SOl. 


Port 1 Port 2 


$00 SOC Printer/Modem 

$01 SOD Line Length (Any/40/72/80/132) 

$02 SOE Delete LF after CR (No/Yes) 

$03 SOF Add LF after CR (No/Yes) 

$04 $10 Echo (No/Yes) 

$05 $11 Buffer (No/Yes) 

$06 $12 Baud Rate 

$07 $13 Data & Stop Bits 

$08 $14 Parity 

$09 $15 DCD Handshake (NOo/Yes) 

SOA $16 DSR Handshake (NOo/Yes) 

SOB $17 XON-XOFF Handshake (No/Yes) 
Display Parameters 

$18 Color/Monochrome 

$19 40/80 Column 

S1A Text Color (00-0F) 

$1B Background Color (00-0F) 

S1C Border Color (00-0F) 

S1D 60/50 Hertz Operation 

$29 Text Language (0=English) 

S2F Flash Rate 
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Keyboard Parameters 


S2A Language (0Q=English) 

$2B Buffering (No/Yes) 

$2C Repeat Speed 

$2D Repeat Delay 

$30 Shift Caps-LowerCase (No/Yes) 
$31 Fast Space-Delete Keys (No/Yes) 
$32 Dual Speed (Normal/Fast) 


Slot Configuration 
$21-27 Slot 1-7 Internal/External 


$28 Boot Slot 
Miscellaneous 

S1E User Volume 

S1F Bell Volume 

$20 System Speed (Normal/Fast) 

S2E Double-Click Time 

$33 High Mouse Resolution 

$34 Date Format 

$35 Time Format 

$36 Min RAM for Ramdisk 

$37 Max RAM for Ramdisk 


$38-40 Count & Languages 

$41-51 Count & Layouts 

$80 AppleTalk Node Number 
$81-Al Operating System Variables 


It is possible, as I said before, to talk directly to the 
battery RAM via I/O addresses. If you learn how to do this, 
and you use the skill to write values into battery RAM, you 
will probably do so without properly changing the checksum. In 
that case you have violated your system, and your next power-up 
will revert to default values for all parameters. It will stay 
that way until you reconfigure everything and/or install a 
proper checksum. The best policy is to use the standard 
firmware tools for all reading and writing, so that the 
checksum stays current. 


You do not have to read or write the whole battery RAM at once. 
There are two tools for reading and writing a single byte. 

Tool Code $0B03 will write one byte, and tool code $0C03 will 
read one byte. The following code segments illustrate how to 
do it. The code as shown must be in Native Mode, with both x- 
and m-bits zero (full 16-bit mode). 


WR PEA $00xx xx is new value for byte 
PEA SO0Oyy yy is address in battery RAM 
LDX ##S0OB03 write xx at yy 
JSL $E10000 
RD PEA $0000 make room for result 
PEA S00yy yy is address in battery RAM 
LDX ##S0C03 read value at yy 
JSL $E10000 
PLA get result from stack (00xx) 
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Insist on GSRAM" 
When You Buy Your IIGs" 


Expand the IIcs RAM and ROM with the GSRAM or GSRAM Plus 
with ROM Pak. Available now with 256K to 8 MEG! 


| GSRAM Plus™ 


( iSRAM™ 


Remember the 16K cards for the I+ and 
the 64K cards for the Ile? At the time, that 
much memory seemed like a lot But when 
the owners of these memory cards came to 
us for more memory, many had to throw 
away their smaller Apple memory cards or try 
to sell them. Most of our customers told us 
that had they known about Applied Engi- 
neering’s larger memory cards when they 
bought their Apple, they would have pur- 
chased them at the same time. 

GSRAM and GsRAM Plus are available now, 
allowing up to 8 MEG of memory expansion. 
That's 8 times the memory capacity of 
Apple's card and just look at the benefits that 
only GSRAM and GSRAM Plus have over 
Apple’s card: 

e Lower cost 

e Has 6 RAM banks (Apple's card has 4) 

e Has memory expansion port 

e Has ROM expansion port 

e No configuration blocks to set 

e No soldered in RAM chips 

e Expandable to 8 MEG 

e Expands AppleWorks intemal limits 

e Built-in Hi-Res self - diagnostic software 

e 5 year hassle free warranty (Apple has a 90 
day warranty) 

e Made in USA 


GsSRAM for More 
AppleWorks Power 

Only GSRAM and GSRAM Plus eliminates 
AppleWorks intemal memory limits, increas- 
ing the maximum number of records avail: 
able from 6,000 to over 25,000 and only Gs- 


) RAM and GSRAM Plus increases the number 


Of lines permitted in the word processing 
mode from 6,000 to over 15,000. And only 
GSRAM and GSRAM Plus offers a builtin 
printer buffer so you can continue using 
AppleWorks while your printer is printing, Gs- 
RAM and GSRAM Plus even expand the 
number of lines in the dipboard from 255 to 


vw 


even have Pinpoint or Macroworks and your 
favorite spelling checker in RAM for instant 
response. GSRAM and GSRAM Plus will even 
display the time and date right on the 
AppleWorks screen. Nothing comes dose to 
enhancing AppleWorks so much. 
Turn Your [lcs into a Giant 

Simply plug GSRAM into the [Ics memory 
expansion slot and you've got up to 8 mega- 
bytes of RAM at your fingertips—all of it 
instandy and automatically recognized by the 
IIGs. GSRAM is compatible with all Ics 
software, including AppleWorks, as well as 
BASIC®, ProDos, DOS 3.3, PASCAL®, “C” and 
CP/M®. 
Grow by Bytes or Megabytes 

We offer GsRAM in two configurations so 
you can increase your memory 256K at a 
time (GSRAM) or a megabyte at a time (Gs- 
RAM Plus). Both offer full compatibility, lower 
cost than other boards, and easy expandabil- 
ity. And both are extremely low in power 
consumption. A fully expanded GSRAM oper- 
ates at only 375 ma, and GSRAM Plus at only 
270 ma (even with 6 megabytes on board!) 
GSRAM—for Normal 
Memory Requirements 

GSRAM is available with 256K, 512K, 1 
MEG or 1.5 MEG of memory already on 
board. If you don’t need the full 1.5 MEG 
now, you can choose a GSRAM with less 
memory and expand it up to 1.5 MEG in the 
future— or upgrade to GSRAM Plus for a 
small charge. 


“I recommend 
Applied 

) Engineering 
products 
wholebeartedly.”’ 


Steve Wozniak, the creator 


| With an optional piggyback card, you can 
| expand GSRAM even higher than 1.5 MEG! 
! (Other cards are only expandable to 1 MEG.) 
GSRAM Plus—for Growing 
by Leaps and Bounds 
GSRAM Plus is the first Apple memory card to 
use 1 MEG RAM chips on the main board 
Its available with 1 to 6 MEG on board. If 
you don’t need the whole 6 MEG now, you 
can buy a GSRAM Plus with less memory and 
easily expand it in the future. 
GSRAM Plus can be expanded up to 8 
MEG with an optional piggyback card. 
Easy Expansion 
Both GSRAM and GSRAM Plus use standard 
RAM chips that are readily available and just 
plug right in. So unlike other cards, you'll find 
expanding your GSRAM or GSRAM Plus easy, 
convenient and very economical And with 
our Optional ROM expansion module you 
can even increase the IIGs's ROM space and 
all in just one slot 
Quality and Support of the 
Industry Leader 
Applied Engineering is the largest supplier 
of Apple peripherals in the word We 
invented the first large RAM cards for the 
Apple. With a 5-year “no-hassle” warranty and 
outstanding technical support, you can be 
sure GSRAM and GSRAM Plus will deliver the 
performance you're looking for—or retum 
them within 15 days for a full refund. 


GSRAM with 256K 
GSRAM with 512K 
GsRAM with 1 MEG 


GSRAM with 1.5 MEG 
GSRAM with 2-8 MEG 


GSRAM Plus with 1-8 MEG 


Order today! 

See your dealer or call Applied Engineering 
today, 9 am. to 11 pm 7 days Or send 
check or money order to Applied Engineer: , 
ing MasterCard, VISA and CO.D. welcome. 
Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A 


ZC APPLIED ENGINEERING” 
The Apple enhancement experts. 


(214) 241-6060 


P.O. Box 798, Carrollton, TX 75006 


| 
| 


2047 and will auto segment large files so they 
can be saved on two or more disks You can 


of Apple Computer 


| CP/M is a registered trademark of Digital Research, Inc. 
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The first clock 


card to add time 
and date to 


AppleWorks’ 
screens and files. 


Timemaster H.O, So many 
features its become the worlds 
best selling clock card. 


tS the smartwary to pat the Gime and date on your Apple 

Het or ht" Because only the Timemaster PEO: packs 
AZ? the importint features of all the competion combaied. 
including leap vear Vear Caot just i PRO DOS) month, 
date. chy ob week. hours. minutes, seconds wad mall 
seconds. Its totally PRO DOS. DOS 33. PASCAE and CP MM 
compauble And, of course, ib Works better than any other 
clock with AppleWorks. 

With the Timemaster LEO. vourre assured of rehable. 
trouble free operation dong with simple, one command 
time setting. accuracy through feap vears. dich te Girne 
Mntane Ite rrupe scuing 

Hvoure using or writing software for other clock 
cards, vou re sull covered) Because the EO: will aedonmicl 
ically emulate theny And onl the Timemaster BLO. adds 1S 
new commands to BASIC The HO even comes complete 
with two disks full of sample programs, including «comput 
erized appointment book. a DOS dating program. mteorrupt 
programas, dnd over 40 programs that others charge vou 
eXtra for or don teven offer As a low cost option. vou 
cain add true BSR remote control to tae PhO: giving vou 
remote control ol up to Lo lehts and appliaaces in your 
home or office 


‘Time in hours. minutes, seconds and milliseconds, date 
with vear month. chi of week and leap vours 2 hour 
military formator 12-hour \MPM formats Bight soli ure 
controlled interrupts so vou can ran two programs ae the 
same time Can examples included) * Can be set to the 
second ® Allows AppleWorks to time and date stamp all data 
dutomatically * Displays time and dare on AppleWorks 
screens tnd files © Fives Gar Warrant 

Timemaster H.O. $129.00 

BSR option (may be added later ) § 49.00 


Call to order today, 9 am. to TE pam seven chivs, or 
send check or money order to Apphed Enginvering Master 
Card. VISA and COD. welcome Texas residents add 3? 5" 
sales tix, Addl $10.00 outside (S24. 


Fras wa Applied Engineering 


The Apple enbancement experts. 
P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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Viewmaster 8O 


Now run 
AppleWorks on 
your Il-and keep 
full 80 column 

compatibility! 


rswarrews |. | | 
neoremt = fea foe es Pee Ps 


() ne look at the chart will give vou some of the 
reasons there's only one smart choice in 80 
column cards for vour Apple. But the real secret to 
Viewmaster 80's success is something even better: 
Total compaubility. 

Each Viewmaster 80 includes our powerful Apple 
Works expand software, allowing AppleWorks to run on 
the I}+ with only 64K Cor more) memory. (We recom. 
mend the RamFactor memory card, but anv compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CPM, 
Pascal, WordStar, Format Hl, Applewriter TH. dBase U. 
Visicale, Muluplan, and Aradreds of others — includ: 
ing AppleWorks. 

Here are just.a few of the powerful features the 
Viewmaster 80 delivers fora great price ($139): 

* 80 Characters by 2-4 lines * Fully compatible with all 
Apple languages and software * Highest compatibility 
with existing 80 column software * Very low power con- 
sumpuon * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal; ali on-screen editing functions are sup- 
ported ¢ User-definable cursor shape * Compatible with 
Apple UH, U + and Ie * Five-year warranty 

Call today to order or for more information, 9 am. 
to 11 p.m. seven davs, or send check or money order to 
Applied Engineering. MasterCard. VISA and CO.D. wel- 
come. Texas residents add S's sales tax) Add $10.00 
outside U.S.A. 


Fu al Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


-Copyright (C) S-C SOFTWARE 


The Clock/Calendar Chip not only contains the battery RAM; it 
also contains the date and time information, naturally. There 
are three tools for reading and writing the time and date. You 
can read time/date in either hexadecimal format or as an ASCII 
string, and you can write a new time/date in a hex format. The 
following code segments illustrate how to use the tools. 


Read.Time.Into.ASCII.String 
PEA BUFFER/256/256 Hi 16-bits of buffer address 
PEA BUFFER Lo 16-bits of buffer address 
LDX ##SO0F03 Tool Code 
JSL $E10000 


The date and time will be converted to ASCII (with msb = 1) and 
stored in BUFFER, according to the formats selected in the 
configuration menu (stored in battery RAM locations $34 and 
$35). The most likely choice among North Americans will be the 
format “mm/dd/yy HH:MM:SS xM", but you have five other 
possibilities. 


Read. Time .Hex 
PEA 0 Make room for 8 bytes 
PEA 0 to be returned 


0 
LDX ##S0D03 
JSL $E10000 


PLA Get SMMSS (minutes, seconds) 
STA MMSS 

PLA Get SyyHH (year, hours) 

STA YYHH 

PLA Get S$mmdd (month, day) 

STA MMDD 

PLA Get day of week (in low byte) 
STA DOW 


The value for day of week runs from 0 to 6, with O=Sunday. The 
value for “day" is 0-30, meaning that you have to add 1 to get 
the true day number. (Why? This is a little ridiculous!) 
Likewise, the value for month is O-ll, with 0 standing for 
January. (I can understand why the hardware might work with 
O-based values for day and month, but why couldn't the firmware 
do the correction to “real” day and month numbers?) The year 
is specified as the actual year number minus 1900. I hope that 
means my //gs will still give correct dates after 1999. If the’ 
value of the "yy" byte can go all the way to 255, then we could 
use //gs until the end of the year 2155. Frankly, I think I'll 
get tired of computers before then. 


To write a new date and time out to the Clock chip, you have to 
push the values onto the stack and call the tool: 


Write.New.Time 
PEA $mmdd month, day 
PEA SyyHH year, hour 
PEA SMMSS minute, second 
LDX ##S0E03 
JSR $E10000 
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Again, the month and day values are zero-based. Note that you 
cannot update the day-of-week directly; apparently it is only a 
CALCULATED value provided when you READ the date/time in hex 
format. 


You might wonder whether anyone would really NEED all the above 
information. After all, Apple has provided the configuration 
system to see/modify all those parameters. The problem is you 
cannot really use that system unless you can SEE. A lot of 
Apple owners are not able to see, so they use the ECHO or other 
some other brand of speech synthesizer to speak everything that 
goes out to the screen. The configuration program cannot be 
made to speak, as it is now written. Larry Skutchan is 
planning to write some sort of speaking version of the 
configurator, and the information above is just what he needs. 


— 5 oft. 


Basic-like macros for the S-C Macro Assembler. 
Available for the Apple I[, If +, //e, and //c. 

Uses whatever DOS your S-C Macro Assembler uses. 
Soon to be released for PRODOS. 

Source code included with every disk!!! 

Cost? A paltry $30.00!!! 


To Order — Send Check or Money Order to: 


DR Mark Manning 


Simul | 
Bagey Gomez c/o Baggy Games 


P. 0. Box 591894 
Houston, Texas 77259-1894 


Apple is a registered Trademark of Apple Computer Inc. 
The S-C Macro Assembler is produced by The S-C Software Corporation. 
EnterSoft is produced by Mark Manning/Simulacron |/Baggy Games 


Apple Assembly Line (ISSN 0889-4302) is published monthly by S-C SOFTWARE 
CORPORATION, P.O. Box 280300, Dallas, Texas 75228. Phone (214) 324-2050. 
Subscription rate is $18 per year in the USA, sent Bulk Mail; add $3 for First 
Class postage in USA, Canada, and Mexico; add $14 postage for other countries. 
Back issues are available for $1.80 each (other countries add $1 per back 
issue for postage). A subscription to the newsletter and the Monthly Disk 
containing all source code is $64 per year in the US. Canada and Mexico, and 
$87 to other countries. 


All material herein is copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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